home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xi / XAllowDeviceEvents.z / XAllowDeviceEvents
Text File  |  1998-10-30  |  10KB  |  199 lines
  1.  
  2.  
  3.  
  4.      XXXXAAAAlllllllloooowwwwDDDDeeeevvvviiiicccceeeeEEEEvvvveeeennnnttttssss((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))XXXXAAAAlllllllloooowwwwDDDDeeeevvvviiiicccceeeeEEEEvvvveeeennnnttttssss((((3333XXXX11111111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XAllowDeviceEvents - release queued events
  10.  
  11.      SSSSYYYYNNNNTTTTAAAAXXXX
  12.           XAllowDeviceEvents(_d_i_s_p_l_a_y, _d_e_v_i_c_e, _e_v_e_n_t__m_o_d_e, _t_i_m_e)
  13.                 Display *_d_i_s_p_l_a_y;
  14.                 XDevice *_d_e_v_i_c_e;
  15.                 int _e_v_e_n_t__m_o_d_e;
  16.                 Time _t_i_m_e;
  17.  
  18.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  19.           _d_i_s_p_l_a_y     Specifies the connection to the X server.
  20.  
  21.           _d_e_v_i_c_e      Specifies the device from which events are to be
  22.                       allowed.
  23.  
  24.           _e_v_e_n_t__m_o_d_e  Specifies the event mode.  You can pass
  25.                       _A_s_y_n_c_T_h_i_s_D_e_v_i_c_e, _S_y_n_c_T_h_i_s_D_e_v_i_c_e,
  26.                       _R_e_p_l_a_y_T_h_i_s_D_e_v_i_c_e, _A_s_y_n_c_O_t_h_e_r_D_e_v_i_c_e_s, _S_y_n_c_A_l_l, or
  27.                       _A_s_y_n_c_A_l_l.
  28.  
  29.           _t_i_m_e        Specifies the time.  You can pass either a
  30.                       timestamp or _C_u_r_r_e_n_t_T_i_m_e.
  31.  
  32.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  33.           The _X_A_l_l_o_w_D_e_v_i_c_e_E_v_e_n_t_s function releases some queued events
  34.           if the client has caused a device to freeze.  It has no
  35.           effect if the specified time is earlier than the last-grab
  36.           time of the most recent active grab for the client and
  37.           device, or if the specified time is later than the current X
  38.           server time.
  39.  
  40.           The following describes the processing that occurs depending
  41.           on what constant you pass to the event_mode argument.
  42.  
  43.           _A_s_y_n_c_T_h_i_s_D_e_v_i_c_e
  44.                       If the specified device is frozen by the client,
  45.                       event processing for that device continues as
  46.                       usual.  If the device is frozen multiple times
  47.                       by the client on behalf of multiple separate
  48.                       grabs, _A_s_y_n_c_T_h_i_s_D_e_v_i_c_e thaws for all.
  49.                       _A_s_y_n_c_T_h_i_s_D_e_v_i_c_e has no effect if the specified
  50.                       device is not frozen by the client, but the
  51.                       device need not be grabbed by the client.
  52.  
  53.           _S_y_n_c_T_h_i_s_D_e_v_i_c_e
  54.                       If the specified device is frozen and actively
  55.                       grabbed by the client, event processing for that
  56.                       device continues normally until the next key or
  57.                       button event is reported to the client.  At this
  58.                       time, the specified device again appears to
  59.                       freeze.  However, if the reported event causes
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXAAAAlllllllloooowwwwDDDDeeeevvvviiiicccceeeeEEEEvvvveeeennnnttttssss((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))XXXXAAAAlllllllloooowwwwDDDDeeeevvvviiiicccceeeeEEEEvvvveeeennnnttttssss((((3333XXXX11111111))))
  71.  
  72.  
  73.  
  74.                       the grab to be released, the specified device
  75.                       does not freeze.  _S_y_n_c_T_h_i_s_D_e_v_i_c_e has no effect
  76.                       if the specified device is not frozen by the
  77.                       client or is not grabbed by the client.
  78.  
  79.           _R_e_p_l_a_y_T_h_i_s_D_e_v_i_c_e
  80.                       If the specified device is actively grabbed by
  81.                       the client and is frozen as the result of an
  82.                       event having been sent to the client (either
  83.                       from the activation of a GrabDeviceButton or
  84.                       from a previous AllowDeviceEvents with mode
  85.                       SyncThisDevice, but not from a GrabDevice), the
  86.                       grab is released and that event is completely
  87.                       reprocessed.  This time, however, the request
  88.                       ignores any passive grabs at or above (toward
  89.                       the root) that the grab-window of the grab just
  90.                       released.  The request has no effect if the
  91.                       specified device is not grabbed by the client or
  92.                       if it is not frozen as the result of an event.
  93.  
  94.           _A_s_y_n_c_O_t_h_e_r_D_e_v_i_c_e_s
  95.                       If the remaining devices are frozen by the
  96.                       client, event processing for them continues as
  97.                       usual.  If the other devices are frozen multiple
  98.                       times by the client on behalf of multiple grabs,
  99.                       _A_s_y_n_c_O_t_h_e_r_D_e_v_i_c_e_s "thaws" for all.
  100.                       _A_s_y_n_c_O_t_h_e_r_D_e_v_i_c_e_s has no effect if the devices
  101.                       are not frozen by the client.
  102.  
  103.           _S_y_n_c_A_l_l     If all devices are frozen by the client, event
  104.                       processing (for all devices) continues normally
  105.                       until the next button or key event is reported
  106.                       to the client for a grabbed device, at which
  107.                       time all devices again appear to freeze.
  108.                       However, if the reported event causes the grab
  109.                       to be released, then the devices do not freeze.
  110.                       If any device is still grabbed, then a
  111.                       subsequent event for it will still cause all
  112.                       devices to freeze.  _S_y_n_c_A_l_l has no effect unless
  113.                       all devices are frozen by the client.  If any
  114.                       device is frozen twice by the client on behalf
  115.                       of two separate grabs, _S_y_n_c_A_l_l thaws for both.
  116.                       A subsequent freeze for _S_y_n_c_A_l_l will only freeze
  117.                       each device once.
  118.  
  119.           _A_s_y_n_c_A_l_l    If all devices are frozen by the client, event
  120.                       processing for all devices continues normally.
  121.                       If any device is frozen multiple times by the
  122.                       client on behalf of multiple separate grabs,
  123.                       _A_s_y_n_c_A_l_l thaws for all.  _A_s_y_n_c_A_l_l has no effect
  124.                       unless all devices are frozen by the client.
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXAAAAlllllllloooowwwwDDDDeeeevvvviiiicccceeeeEEEEvvvveeeennnnttttssss((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))XXXXAAAAlllllllloooowwwwDDDDeeeevvvviiiicccceeeeEEEEvvvveeeennnnttttssss((((3333XXXX11111111))))
  137.  
  138.  
  139.  
  140.           _A_s_y_n_c_T_h_i_s_D_e_v_i_c_e, _S_y_n_c_T_h_i_s_D_e_v_i_c_e, and _R_e_p_l_a_y_T_h_i_s_D_e_v_i_c_e have
  141.           no effect on the processing of events from the remaining
  142.           devices.  _A_s_y_n_c_O_t_h_e_r_D_e_v_i_c_e_s has no effect on the processing
  143.           of events from the specified device.  When the event_mode is
  144.           _S_y_n_c_A_l_l or _A_s_y_n_c_A_l_l, the device parameter is ignored.
  145.  
  146.           It is possible for several grabs of different devices by the
  147.           same or different clients to be active simultaneously.  If a
  148.           device is frozen on behalf of any grab, no event processing
  149.           is performed for the device.  It is possible for a single
  150.           device to be frozen because of several grabs.  In this case,
  151.           the freeze must be released on behalf of each grab before
  152.           events can again be processed.
  153.  
  154.           _X_A_l_l_o_w_D_e_v_i_c_e_E_v_e_n_t_s can generate a _B_a_d_D_e_v_i_c_e or _B_a_d_V_a_l_u_e
  155.           error.
  156.  
  157.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  158.           _B_a_d_D_e_v_i_c_e   An invalid device was specified.  The specified
  159.                       device does not exist or has not been opened by
  160.                       this client via _X_O_p_e_n_I_n_p_u_t_D_e_v_i_c_e.  This error
  161.                       may also occur if the specified device is the X
  162.                       keyboard or X pointer device.
  163.  
  164.           _B_a_d_V_a_l_u_e    An invalid mode was specified on the request.
  165.  
  166.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  167.           XGrabDevice(3X11)
  168.           _P_r_o_g_r_a_m_m_i_n_g _W_i_t_h _X_l_i_b
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 4/30/98)
  196.  
  197.  
  198.  
  199.